home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 11 / AMUG BBS in a Box Volume XI (April 1994) (MacWizards).iso / CD Setup / Mansion Setup / Doc's / Mansion setup < prev   
Encoding:
Text File  |  1991-08-01  |  4.6 KB  |  103 lines  |  [TEXT/MPS ]
  1. The CD you now have in your CD-ROM drive, contains a wealth of
  2. information, a huge number of files. At first sight, it is very
  3. difficult to hook all this up to your Mansion system. At
  4. second sight... but no, that's another BBS system.
  5.  
  6. This document should make the task of making this CD-ROM
  7. available to your users a bit easier.
  8.  
  9. The creators of this CD-ROM wisely figured that there should
  10. be some simple way to define what's on the CD-ROM, a way
  11. to make it easier for you and your users to find the files
  12. of their liking. What they defined is a tab-delimited
  13. file, one copy of which you will find in each file section.
  14. For example, when you look in the folder 'MIDI' in the
  15. folder 'files' you will find a file called ' MIDI.db' (the
  16. space in front of the name helps make sure that it's on top
  17. of any list of files the finder may present to you.
  18. This file contains all the information on the MIDI part of
  19. the CD-ROM. You will find a file like this in all the folders.
  20.  
  21. The next step was simple as well. Some programmer had to take
  22. this file format, and write something that translated it to
  23. Mansion format. That programmer turned out to be me.
  24. The utility is called 'BBSinaBox' and can be found in the same
  25. folder as this document.
  26. Should you decide to disregard the prepared Section.Dir files
  27. on this CD-ROM, you can use this utility to create your
  28. own section.dir files based on the .db files.
  29.  
  30. Take the following steps.
  31.  
  32. 1) with your favourite text editor, concatenate all the *.db
  33. files you want included.
  34. 2) put the resulting text file in a new folder
  35. 3) put the utility in the same folder
  36. 4) create a folder called 'CD ROM' in the same folder
  37. 5) run the utility, and select the concatenated file.
  38. 6) When it asks you to select a file again, click cancel.
  39.  
  40. You now have a couple of files. One is called Lib Header, and
  41. it contains the same lines as a normal Lib Header file. The
  42. other is called Mansion Menu Lines, and it contains the lines
  43. you can almost use for your setup. When you copy lines from
  44. this file to your menu structure, all you have to do is
  45. change the menu text to something you like better than what's
  46. put there automatically, and second you have to assign it
  47. a keystroke you callers can use to select the menu.
  48. You must remember to change one thing in the Lib Header file.
  49. For every line in the Lib Header file, there is menu file
  50. number defined (check page 10 of you Mansion manual). Default
  51. this is set to 0000. You must change this to your download
  52. menu. An example is included in the "menu's" folder.
  53.  
  54. There's also a file called 'Inabox.log' and this file contains
  55. the pathnames of all files on the CD-ROM which could not be
  56. incorporated into a Section.Dir file because of file names
  57. that are too long.
  58. The folder 'CD ROM' contains all the Section.Dir files.
  59.  
  60.  
  61. Working with a CD-ROM is subtly different from working with
  62. a hard disk with Mansion. Normally, the Section.Dir files
  63. are in the same directory as the files it describes. With
  64. a CD-ROM however, this is not possible, since Mansion wants
  65. to update this file with the number of downloads. The solution
  66. is simple (and can be found in the manual, of course...). In
  67. the Mansion Data folder on you hard disk, there's a folder
  68. called 'CD ROM'. In this folder you will find all the
  69. Section.Dir files for the directories on read-only volumes.
  70. However, instead of 'Section.Dir', the name of the file will
  71. be extended to include the number of the file section, a
  72. number you can also find in the Lib Header file. An example
  73. would thus be 'Section.Dir 1' for file area one.
  74.  
  75.  
  76. Things will be simplest if you use the Section.Dir files
  77. provided on CD-ROM. They come together with a set of menu
  78. files, set up by me to represent one way of looking at the
  79. CD-ROM.
  80.  
  81. Therefore, you find on this CD-ROM not only the utility, but
  82. also it's product: a folder with Section.Dir files, the
  83. Lib Header file, and a file with Mansion Menu Lines for you
  84. to create your own menu structure. For the terminally lazy I
  85. included a folder "Menu's" as well, which contain menu's
  86. based on the Section.Dir and Lib Header files. You can use
  87. these in combination with the Lib Header file, (and probably
  88. modify them to include your existing library area's).
  89. If you decide to use the menu's in the menu folder, you must
  90. change the Lib Header file to have all sections go to
  91. menu number 500, instead of 0000. Of course, you can also
  92. use your own generic download menu. Check page 10 of the
  93. Mansion manual.
  94.  
  95. Note that the menu's in the "Menu's" folder may also
  96. be useful as a starting point for creating your own selection
  97. of the CD-ROM. All you need to do is make sure the library
  98. section numbers are correct in all menu lines for your setup.
  99.  
  100. Have fun!
  101.  
  102.  
  103. -John W. Sinteur, 2:512/114